home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / pcutils / dos / vfd / vfd.doc < prev    next >
Text File  |  1995-12-30  |  35KB  |  708 lines
  1.  
  2.                             VFD(tm) Video for DOS 
  3.                            Release 1.6d (01/05/95)
  4.              Copyright (c) 1994 by Bob Williamson  CIS 76570,2752
  5.                
  6.       VFD(tm) is a DOS command-line motion video cross-compiler for creating 
  7.       .FLC, .FLI and .AVI files from:
  8.  
  9.       Windows .DIB files (all BMP & RLE)
  10.       Windows .BMP files (1, 4, 8, 16 & 24-bit)
  11.       Windows .RLE files (4 & 8-bit, including deltas)
  12.       IBM OS/2 .BMP files (1, 4, 8 & 24-bit)
  13.       Truevision .TGA files (8, 16, 24 & 32-bit rle & uncmp)
  14.       CompuServe .GIF files (PC & Mac 87a, 89a)         
  15.       Zsoft .PCX files (8 & 24-bit)                     *registered version*
  16.       Autodesk .FLC and .FLI files (all)
  17.       Windows .AVI files (RLE and 8, 16, & 24-bit DIB)
  18.       MPEG .RAW files produced by DMPEG.EXE v1.1 (8 & 24-bit)
  19.  
  20.       VFD will extract a numpic file series from FLC, FLI, RAW, and AVI 
  21.       (RLE & DIB only) in BMP, RLE, GIF, PCX or TGA formats.  Direct 
  22.       conversion of FLC, FLI, AVI and single image formats is also supported.
  23.  
  24.       VFD uses an advanced method of color quantitization called Hilite
  25.       Promotion (Scaleable Adaptive, Histogram-based).  Hilite Promotion 
  26.       produces 8-bit motion video with high color fidelity and image 
  27.       resolution from a diverse range of image files and palettes by using 
  28.       scaleable quantitization (color reduction) and variable dither 
  29.       intensity.  Hilite Promotion can be used to create an optimum palette 
  30.       containing both the most popular colors and the most diverse colors 
  31.       from the input images.
  32.  
  33.       Hilite Promotion was developed as a solution to the motion video color 
  34.       quantitization problem of multiple images and palettes.  It may be 
  35.       used for building compatible Windows identity palettes for one or more 
  36.       bit-mapped images to be displayed by Windows, as well as motion video.
  37.  
  38.       PARAMS:
  39.  
  40.       VFD options may be invoked by use of command-line parameters.  The
  41.       parameters follow the infile, preceded by a space and either a forward 
  42.       slash '/' or a hyphen '-'.  The params may be in any order and are case 
  43.       insensitive.  Typing 'VFD <enter>' will display a list of the options: 
  44.       
  45.   VFD infile [params]
  46.   -I         create .FLI (default is .FLC)
  47.   -An        create .AVI n=1 8-bit DIB, n=2 RLE 
  48.   -En        Extract numpic series n=1 8-bit .BMP, n=2 .RLE delta, n=3 .GIF
  49.              n=4 8-bit .PCX, n=5,6,7: 8,16,24-bit .TGA uncmp
  50.   -Sn        playback Speed in frm/sec n=0.1 to 99 (default=15)
  51.   -Ofname    Outpath [d:\path\]fname (default fname=infile w/ outtyp .ext)
  52.   -Tn1[,n2]  Total frames n1=start, n2=total count (disables B2 pingpong)
  53.   -Mn        CoMpression n=1 50%, n=2 67%, n=3 75%, n=4 80%, ..., n=99 99%
  54.   -Kn        Keyframe interval n=1 to 65535 (Default is no keyframes)
  55.   -Bn        Backward n=1, pingpong n=2, mirror n=3, flip n=4 (B1,B2:numpic)
  56.   -Rn        Resize n=1 1/2, n=2 2x n=3 override dflt FLI aspect correction
  57.   -Cn        Color count n=2 to 255 (default=256)
  58.   -Hn        Hilite promotion (range 0 to 255) 
  59.   -Dn        Dither (intensity range 0 to 255)
  60.   -L±n[,c]   Luminance n=1 to 255 (+ lite, - dark) (c=r,g,b: red,green,blue)
  61.   -Wn        Windows identity palette n=1 mapped, n=2 not mapped
  62.   -Fn        Fixed Windows id pal n=1 256 colr, n=2 gray, n=3 hlftne, n=4 b&w
  63.   -Pn        write Pal n=1 RIFF .PAL, n=2 DIB .PAL, n=3,4 AA,AAPro .COL,
  64.              n=5 PicLab .MAP, n=6 PSP .PAL, n=7 NeoPnt .PAL, n=8 generic .PAL
  65.  
  66.       The infile may be any of the above listed image file formats.  VFD 
  67.       will read a numpic series if wildcards ('*' or '?') are used in the 
  68.       file name. The infile may include the path. The output file path is 
  69.       the current default.  Examples:
  70.  
  71.       VFD pretty00.bmp                     (produce a one frame .FLC
  72.                                            PRETTY.FLC)
  73.  
  74.       VFD pretty*.rle                      (produce a 100 frame .FLC
  75.                                            starting w/ pretty00.rle
  76.                                            thru pretty99.rle named
  77.                                            PRETTY.FLC)
  78.  
  79.       VFD d:\pretty\pretty??.rle -a2 -w1   (produce PRETTY.AVI with a 
  80.                                            Windows identity palette)
  81.  
  82.       VFD pretty.avi -i                    (produce PRETTY.FLI)
  83.                                            
  84.       MAKEFILE:
  85.  
  86.       Typing 'VFD -? <enter>' will display the following:
  87.  
  88.       The infile for VFD may be a text file with the extension of .MAK which 
  89.       lists the source image files and optional keywords.  If a motion video 
  90.       file is used in the makefile, it must be the only input image file.  
  91.       The keywords are: 
  92.       
  93.             REPEAT_n (repeat the previous input file 'n' times)
  94.             PINGPONG (read the previous numpic series in reverse order) 
  95.             BACKWARD (read the following numpic series in reverse order)
  96.             MIRROR_ON (the following frames will be mirror-image)
  97.             MIRROR_OFF (turn mirror-image off)
  98.             FLIP_ON (the following frames will be inverted)
  99.             FLIP_OFF (turn inverted off)
  100.             TRANSPARENT_r,g,b (the rgb color will be transparent - AVI only)
  101.             TRANSPARENT_OFF (turn transparent off)
  102.             KEYFRAME (the following frame will be a keyframe)
  103.             CD-ROM (the AVI video chunks will be padded for CD-ROM playback)
  104.             CROP_n1,n2,n3,n4 (n1=top, n2=left, n3=width, n4=height) zero base
  105.       
  106.       Keywords are not case-sensitive.  The comment character is a semicolon.
  107.  
  108.       Example text of PRETTY.MAK:
  109.                                  ;216 frames, 320x240, identity pal
  110.                                  pretty.pal
  111.                                  d:\pretty\pretty00.bmp
  112.                                  REPEAT_8
  113.                                  d:\pretty\pretty??.bmp
  114.                                  d:\pretty\pretty99.bmp
  115.                                  REPEAT_8
  116.                                  PINGPONG
  117.  
  118.      The above example will produce PRETTY.FLC containing 10 frames of 
  119.      pretty00.bmp, 98 frames of pretty01.bmp thru pretty98.bmp, 10 frames 
  120.      of pretty99.bmp and 98 frames of pretty98.bmp thru pretty01.bmp.  The
  121.      palette file pretty.pal will be used for the motion video palette.
  122.      PINGPONG repeats the previous numpic series in reverse, omitting the 
  123.      first and last frames.  
  124.  
  125.      The maximum frame count is 65535.  The maximum makefile size is 16kb.
  126.      Numpic series with the same base name are limited to a maximum of 5460 
  127.      frames.  VFD reads stdin for response to input prompts.  VFD may be 
  128.      invoked in a batch file (.BAT) using redirection of a text file for 
  129.      input response.  The system date, time and command line params are 
  130.      inserted as the first comment line in the makefile each time the 
  131.      makefile is processed by VFD.  Input image files are opened read-only.
  132.      
  133.      The .MAK extension is not required on the command line.  'VFD pretty' 
  134.      is equivilent to 'VFD pretty.mak'.
  135.  
  136.      HILITE PROMOTION:
  137.       
  138.      Any combination of input image types and color formats (1 to 32 bit) 
  139.      may be combined in a VFD makefile.  If the total color count exceedes 
  140.      256, Hilite Promotion and dither should be used to obtain the optimum 
  141.      output for 8-bit video.  VFD builds a popularity histogram of all the 
  142.      colors from the input images.  The motion video palette consists of the 
  143.      256 most popular colors less the Hilite Promotion value.  The Hilites 
  144.      are then added to the motion video palette from the remaining colors in 
  145.      the histogram.  The Hilites are selected as those colors in the 
  146.      histogram having the greatest difference from the colors already 
  147.      included in the motion video palette.  If the '-Cn' (color count) option 
  148.      is used, the Hilite value is subtracted from the color count.  Black, by 
  149.      default, is always the first color in the motion video palette.
  150.  
  151.      A Hilite value of 255 (true-cut) will produce results similar to the 
  152.      standard unbiased median-cut method of color reduction.  With Hilite 
  153.      promotion, the palette colors are actual colors from the input images, 
  154.      not averaged colors.  Lower Hilite values (-H128) will often produce the 
  155.      best results for motion video and generate a smaller file, as less 
  156.      dither is required.  The lower value guarantees inclusion of the true 
  157.      most popular colors in the video palette.  If reducing a single image, 
  158.      or making a slide show, use -H255 -D128 for best results.
  159.  
  160.      Motion video created from digital video capture (16/24-bit color) can be 
  161.      converted to  8-bit color motion video with very good results by using 
  162.      Hilite Promotion and dither.  Start with -H128 -D20 and adjust up or 
  163.      down to produce the best result.  For ray trace input, start with -H160  
  164.      -D8. As Hilite value increases, the dither requirement decreases.
  165.  
  166.      A default Hilte and Dither value is used if the color count exceeds
  167.      255 and no Hilite and Dither values are given on the command line.
  168.      The default is replaced by the command line values when they are given.
  169.      Params of -H0 and -D0 will disable the defaults.
  170.  
  171.      DITHER:
  172.  
  173.      Dither will reduce or eliminate 'color banding'.  Dither may be used 
  174.      even when the total color count is less than 256.
  175.  
  176.      VFD uses the 'Floyd-Steinberg' dither pattern in alternating direction
  177.      (serpentine).  The dither intensity (-Dn) is the maximum difference 
  178.      between the true pixel value and the motion video palette value that 
  179.      will be used in the error dispersion.  Lower dither values produce less 
  180.      'background animation'.
  181.  
  182.      COMPRESSION:
  183.  
  184.      Motion video compression (data rate reduction) may be achieved in two 
  185.      ways: Reduce the data content (image quality) of each frame, or by 
  186.      reducing the frame count and the playback speed by a corresponding 
  187.      amount.  VFD uses the second of the two compression methods.  VFD motion 
  188.      video image quality is always 100%.  The range (-Mn) is n=1 50% to n=99 
  189.      99%.  Compression may be used with Extraction of a numpic series as well 
  190.      as motion video output.  Example:
  191.  
  192.               -M1    write 1, skip 1, write 1, ...    Speed/2     50%
  193.               -M2    write 1, skip 2, write 1, ...    Speed/3     67%
  194.               -M3    write 1, skip 3, write 1, ...    Speed/4     75%
  195.               ...
  196.               -M99   write 1, skip 99, write 1, ...   Speed/100   99%
  197.  
  198.      Use of compression is recommended when processing 24 or 30 frame/sec
  199.      input.
  200.  
  201.      PALETTES:
  202.  
  203.      The motion video palette may be output with the '-Pn' param. VFD reads
  204.      and writes the following palette formats: 
  205.  
  206.                   -P1     RIFF .PAL (VFW PalEdit)
  207.                   -P2     DIB .PAL (Windows Paintbrush)
  208.                   -P3,4   AA,AAPro .COL (Autodesk Animator, AA Pro)
  209.                   -P5     ascii .MAP (PicLab - DOS Public Domain)
  210.                   -P6     ascii .PAL (Paint Shop Pro - Windows Shareware)
  211.                   -P7     ascii .PAL (NeoPaint - DOS Shareware)
  212.                   -P8     generic .PAL (Improcess - DOS Shareware)
  213.  
  214.      The programs in parentheses are applications that can read and edit the 
  215.      specific palette format.  Ascii palette files may also be edited with a 
  216.      text editor.  The edited palette may be used as the motion video palette 
  217.      by including it as the first file in the makefile.  The Color count 
  218.      (-Cn) and Windows id pal (-Wn) params are disabled when a palette is 
  219.      read from the makefile.  Windows Paintbrush will only read DIB palette 
  220.      files with 28 colors maximum.
  221.  
  222.      ID PALETTES:
  223.  
  224.      The Windows identity palette option (-Wn) will add the 20 reserved 
  225.      Windows system colors to the motion video palette.  The 20 colors are 
  226.      subtracted from the color count prior to subtracting the Hilite 
  227.      Promotion value.  The identity pal may be mapped (-W1) or not mapped 
  228.      (-W2) to the motion video palette.  VFD maps the closest color in the 
  229.      motion video palette to the color in the input image using the spherical
  230.      distance method.  
  231.  
  232.      Some motion video, while requiring the identity pal for compatibility 
  233.      under Windows, will look better when mapped only to the colors from the 
  234.      input file (-W2).  
  235.  
  236.      FIXED PALETTES:
  237.  
  238.      VFD provides 4 fixed palettes:    -F1 = 256 color Windows identity pal
  239.                                        -F2 = 32 color grayscale Win id pal
  240.                                        -F3 = 32 color halftone Win id pal
  241.                                        -F4 = black & white Windows id pal
  242.  
  243.      The -F1 default is mapped identity pal.  The -F2, -F3 and -F4 defaults 
  244.      are not mapped identity pal.  The defaults may be overridden by use of 
  245.      the -W1 or -W2 params.  Example:
  246.  
  247.                                      -F4 -W1 will use the 20 color Windows
  248.                                      identity palette (b&w are id colors)
  249.  
  250.                                      -F4 -D128 for dithered b&w output
  251.  
  252.      The Luminance '-L±n[,c]' param color channel option '[,c]' may be used 
  253.      to change the tint of the grayscale and halftone palettes.  The '-Cn'
  254.      color count param is disabled when a fixed palette '-Fn' is used.
  255.  
  256.      RESIZE & ASPECT:
  257.  
  258.      The '-R1' param will halve the vertical and horizontal dimensions of 
  259.      the input image.  Example: 640x480 -> 320x240.  The -R2 param will 
  260.      double the vertical and horizontal dimensions of the input file.
  261.      Example: 320x240 -> 640x480.
  262.  
  263.      VFD prompts for screen aspect correction to high resolution mode if 
  264.      the source files are 320x200 and the output format is .FLC or AVI. If 
  265.      the source files are not 320x200 or 160x100 and the output is .FLI, the 
  266.      images are corrected from high resolution mode to FLI aspect by default.
  267.      Default FLI aspect correction may be overridden by using the -R3 param.
  268.  
  269.      The maximum input and output image size is 1024x768.  Input image size 
  270.      for .FLC and .AVI output must be consistant.  Input image size for .FLI 
  271.      output may vary from a maximum of 640x480 (the output for .FLI will 
  272.      always be 320x200, with image centered).
  273.  
  274.      Sequence of geometic operations:   Resize 1/2
  275.                                         Mirror
  276.                                         Resize 2x
  277.                                         Crop
  278.                                         Aspect
  279.      CONVERTING AVIs:
  280.  
  281.      Many .AVI files are compressed with formats for which there are no  
  282.      Public DOS drivers.  These files must be converted to RLE or Full
  283.      Frames with VFW VidEdit or a similar Windows program for use with VFD.  
  284.      If the AVI is 8-bit color, save the file as RLE or 8-bit DIB.  
  285.      For 16 & 24-bit AVIs, save the file as a 16 or 24-bit DIB.
  286.  
  287.      When saving in RLE format for VFD input, set the target to custom, no 
  288.      data rate, no keyframes, no CD-ROM padding, and set quality at 100%.  
  289.      If the data rate is not set to a high value, data may be lost when 
  290.      converting to RLE compression using VidEdit.
  291.  
  292.      AVIs created with VFD may be converted to other compression options 
  293.      with VidEdit.  If VidEdit returns 'out of memory' errors when converting 
  294.      RLE compressed AVIs, use VFD to add keyframes (-K15 -A2).
  295.  
  296.      If you do not already have Video for Windows, it is free for the asking,
  297.      and includes VidEdit, PalEdit, and WavEdit. (VFW is no longer offered for
  298.      retail sale.)  On CIS, download JSCD.TXT, 305 bytes, 13-Jul-94, from the 
  299.      WINMM forum.
  300.  
  301.      For those without CIS access, this is the text file verbatim:
  302.  
  303.      >> To get the Jumpstart CD:
  304.  
  305.      >> 1. Send a Fax to (206)936-7329 attn: MMDRG/Jumpstart.
  306.      >> 2. Send an Internet Email message to mmdinfo@microsoft.com
  307.  
  308.      >> The CD is free for a limited time only. Act today, operators
  309.      >> are standing by, etc, etc.
  310.  
  311.      >> Happy Coding,
  312.  
  313.      >> Rick Segal, Manager, Developer Relations
  314.      >> Microsoft
  315.  
  316.      ** Make sure to include your snail mail address & telephone number.
  317.  
  318.      RLE DELTAS:
  319.  
  320.      Deltas are the differences between the current frame and the previous 
  321.      frame.  Delta encoding uses line and column skips to create 
  322.      transparency.  When a delta input series is processed, the frames are
  323.      overlayed with the transparent portion unchanged from the previous 
  324.      frame.  Delta input series may not be dithered with VFD.  If dither is
  325.      required, the delta series should be extracted from a motion video that 
  326.      was created using dither. 
  327.      
  328.      VFW BitEdit, Paint Shop Pro (Windows Shareware), and AAWIN (Freeware 
  329.      Autodesk player for Windows) read and display RLE deltas correctly.
  330.  
  331.      The first frame of a RLE delta series is a keyframe (opaque), and the 
  332.      following frames are all deltas (transparent except for changes from the 
  333.      previous frame).  Full frame (opaque) RLE series may be extracted by 
  334.      using the Keyframe param: -E2 -K1.
  335.  
  336.      RLE delta input files should not be used with the Backward, Pingpong 
  337.      coMpress, or Total (where n1 > 1) options.
  338.  
  339.      CHROMA KEY OVERLAYS:
  340.  
  341.      Titles, copyright notices, etc. may be added to motion video using
  342.      transparent RLE delta overlays.  First, make a title frame using any
  343.      paint or drawing program, and save it as TITLE1 (in any VFD compatible
  344.      image format). Then create a make file using the TRANSPARENT_rgb keyword
  345.      to set the background invisible, and extract the RLE delta. The makefile
  346.      (title1.mak) should look like this:
  347.  
  348.      TRANSPARENT_0,0,0          ;black
  349.      title1.bmp
  350.  
  351.      Now extract a RLE delta series from the motion video. 
  352.      Example: VFD pretty.avi -e2.
  353.  
  354.      Rename the first RLE image (pretty00.rle) as first.rle.  Create a 
  355.      makefile (pretty.mak) as follows:
  356.  
  357.               first.rle 
  358.               title001.rle
  359.               repeat_20              ;optional
  360.               first.rle              ;optional
  361.               pretty*.rle
  362.  
  363.      'VFD pretty -a2' will produce a new AVI with the title frame overlaying 
  364.      the first frame.  
  365.  
  366.      If the color count exceeds 256, use the '-Cn -Hn -Dn' params to reduce 
  367.      the color count for the RLE delta series extracted from the orginal
  368.      motion video.
  369.       
  370.      SPEED:
  371.  
  372.      VFD may be used to produce slideshows as well as motion video.  Playback 
  373.      speed range is from 0.1 to 99 frames/sec.  Fractional rates above 1 
  374.      frame/sec are not supported.  Some .FLC & .FLI players do not accept 
  375.      speed values less than 1 frm/sec.  VFD produced .AVIs with speeds less 
  376.      than 1 frm/sec may be converted with VFW VidEdit to other compression 
  377.      types and retain a speed of less than 1 frm/sec, even though VidEdit 
  378.      v1.1 will only set rates of 1 to 99 frames/sec. Example: 
  379.      
  380.                       -S.1 = 10 seconds per frame 
  381.                       -S.2 =  5 seconds per frame  
  382.                       -S10 = 10 frames per second
  383.      
  384.      When using VFD to create looping AVI slideshows, the REPEAT_1 makefile 
  385.      keyword should be used to repeat the last frame for play with Win MCI. 
  386.  
  387.      DATA RATE:
  388.  
  389.      The data rate required for playback is displayed for .FLC, .FLI. & .AVIs
  390.      when they are rendered by VFD.  The first frame of .FLCs & .FLIs is  
  391.      ommitted from the calculation because it is displayed only one time,
  392.      and then replaced by the ring frame.  The ring frame is a delta of the
  393.      last and first frames.  AVIs do not have a ring frame.
  394.  
  395.      The coMpress (-Mn) param may be used with a corresponding percentage 
  396.      reduction in playback speed to reduce the data rate (and file size) 
  397.      while maintaining the same apparent speed.  
  398.      
  399.      TOTAL FRAMES:
  400.  
  401.      If extracting from motion video when the start frame (-Tn1) is greater
  402.      than 1, the first extracted frame will be a delta.  To make the first
  403.      frame a keyframe, use VFD to create a video with a Keyframe interval 
  404.      (-Kn) syncronized with the start frame value (n1), and then the start 
  405.      frame will hit the keyframe.  Example: to extract a 100 frame FLC 
  406.      starting at frame 157, use 'VFD pretty.flc -k157 -otmpfle', then 'VFD 
  407.      tmpfle.flc -t157,100 -opretty2'.
  408.  
  409.      If the Total frames param is used with the Backwards param (-B1), the
  410.      start frame is the highest numbered frame defined by the Total frame
  411.      param.  Example: to skip the first file in a 100 frame series using the
  412.      -B1 param: -T1,99. (its backwards)
  413.  
  414.      KEYFRAME INTERVAL:
  415.  
  416.      Keyframes (-Kn where n=1 to 65535) and the KEYFRAME makefile keyword may 
  417.      be used when creating FLC, FLI, RLE compressed AVI, and for RLE delta 
  418.      extraction.  The default is no Keyframes.  Keyframes may be useful in 
  419.      video editing, but are not necessary for playback in VFD produced motion 
  420.      video, as the image quality is always 100%.
  421.  
  422.      Keyframes may also be useful in AVIs with a programmed or script-driven 
  423.      player that seeks to specific frames in response to user input.
  424.  
  425.      Extraction of all full frame RLE images may be accomplished by using the
  426.      -E2 -K1 params.
  427.      
  428.      PADDING:
  429.  
  430.      Padding will improve the data through-put of AVIs when played from 
  431.      CD-ROM.  To add padding, place the 'CD-ROM' keyword in the makefile 
  432.      prior to the image files.  The default is no padding.  The CD-ROM 
  433.      keyword is ignored for FLC and FLI output.
  434.  
  435.      CTRL-BRK:
  436.  
  437.      Use of CTRL-BRK will terminate VFD at any point in processing.
  438.  
  439.      AUDIO:
  440.  
  441.      VFD skips over audio tracks in input files.  VFW VidEdit and WavEdit or 
  442.      similar Windows programs may be used to add audio to VFD produced .AVIs.
  443.  
  444.      AVITXT:
  445.  
  446.      AVITXT.EXE adds plain text comments to AVI files. The comment text is
  447.      limited to 28,000 bytes, and is padded to a 2Kb boundary by default.
  448.      Existing comment text may be replaced with AVITXT. To remove comments, 
  449.      use AVITXT with a text file of zero length (as created with DOS EDIT).
  450.      The Shareware version is limited to DIB, RLE, and msvc AVIs. The AVITXT
  451.      included with the registered VFD will add comment text to all AVIs.
  452.  
  453.      MPEG:
  454.  
  455.      DMPEG v1.1, a Public Domain MPEG viewer and extractor by Stefan Eckart, 
  456.      is included with VFD.  DMPEG.EXE will extract a .RAW file from MPEG Type 
  457.      1 files (see the DMPEG.DOC file).  For best results, the .RAW file 
  458.      should be extracted in 24-bit format for VFD input (DMPEG -d4).  VFD 
  459.      Hilite value of 128 and dither value of 20 usually produce very good 
  460.      results from 24-bit RAW input.  Compress (-M1) and Speed (-S15) will 
  461.      convert the frame rate from 30 frm/sec to 15 frm/sec while retaining the 
  462.      apparent speed of the origional MPEG video.  Many .RAW files can be 
  463.      compressed even more by using '-M2 -S10' or -M3 -S8'.  The Luminance 
  464.      param '-L±n[,c]' will be useful with some MPEG conversions.
  465.  
  466.      JPEG:
  467.  
  468.      VFD does not accept .JPG input files.  JPG files are 24-bit color lossy
  469.      compression and must be converted to another file format for input to
  470.      VFD.  For best results, use Paint Shop Pro (Shareware by JASC, Inc.), to 
  471.      reduce the JPG file to 16-bit color and save as a 16-bit compressed TGA 
  472.      file.  Then use VFD with Highlite promotion to render the TGAs.
  473.  
  474.      Another option producing good results is to use JPG2GIF v2.0, a Freeware 
  475.      program by Handmade Software.  JPG2GIF is a DOS command-line utility 
  476.      that may be run in batch mode to convert JPG to GIF.  The programs are 
  477.      avaliable on CompuServe in the GRAPHSUP forum, Format Conversion 
  478.      library, as PSP.ZIP and GIF2JP.ZIP.
  479.  
  480.      MEMORY & SYSTEM REQUIREMENTS:
  481.  
  482.      VFD.EXE is a DOS real-mode application requiring 500Kb free conventional
  483.      memory and 96Kb XMS memory for processing 320x200 images.  Larger image 
  484.      sizes require additional XMS memory.
  485.      
  486.      DOS 3.1 or greater, 80286 or greater, 4Mb RAM required.  At least 2Mb
  487.      XMS memory should be configured using HIMEM.SYS or equivilent.  A SVGA 
  488.      video card is required to play 256 color .FLC and .AVI files.  FLI files
  489.      use only the standard VGA video modes.  The VFW runtime and 8Mb Ram is 
  490.      required to play AVIs with the Windows v3.1 MCI player.
  491.  
  492.      MOTION VIDEO SOURCES:
  493.  
  494.      The following CompuServe forums are sources for motion video: 
  495.      
  496.      ENERGY: AVI 
  497.      ARCFILM: AVI
  498.      ASOFT: FLC, FLI 
  499.      COMANIM: FLC, FLI, MPG, AVI    
  500.      SPACE: MPG, AVI (NASA uploads)  
  501.      WINMM: AVI (also VFW DK, incl full VFW)
  502.      WINFUN: AVI 
  503.  
  504.      The VFW runtime is in the ENERGY forum and the Autodesk runtime for 
  505.      Windows (WINPLA.EXE) is in the ASOFT forum.  Several FLC/FLI players for 
  506.      DOS are in the GRAPHSUP forum.
  507.  
  508.      TECHNICAL SOURCES:
  509.  
  510.      VFD is written in MASM 6.1 using file format specifications found in the 
  511.      Windows SDK and the following:
  512.  
  513.      CIS:ASOFT: FLCSPC.ZIP
  514.      CIS:WINMM: VFW SDK v1.1 
  515.      Zsoft Corporation Technical Reference Manual, 1991
  516.      CompuServe Graphics Interchange Format(sm), 1990
  517.      Truevision Targa File Format Specification v2.0, 1991
  518.  
  519.      Much credit is due David Hoffmann, Michael Koch, and Vince Pilgrim for 
  520.      their patient counsel and beta test bug reports.
  521.  
  522.      SUPPORT:
  523.  
  524.      VFD continues to be upgraded with new features.  For the latest version,
  525.      GO GRAPHSUP on CompuServe and download VFD.ZIP from the Format Conversion
  526.      library section.
  527.  
  528.      VFD support is provided on CompuServe in the Graphics Support forum 
  529.      (GO GRAPHSUP).  Leave a message in the Format Conversion section for 
  530.      prompt response.  Direct support is also provided from Internet at: 
  531.      
  532.                          76570.2752@compuserve.com
  533.  
  534.      The author of VFD may be reached at the following address:
  535.      (For credit card registration orders, see below.)
  536.  
  537.                              Bob Williamson
  538.                              PO Box 172349
  539.                              Arlington, TX  
  540.                              76003-2349
  541.                              U.S.A.
  542.  
  543.      Developers wanting to add FLI, FLC, and/or AVI edit or playback, 
  544.      including codecs, to their applications are encouraged to contact the 
  545.      author for information on porting.
  546.  
  547.      SHAREWARE:
  548.  
  549.      VFD is copyrighted software that is marketed as Shareware.  The 
  550.      Shareware version of VFD may be used for a 30 day trial period, after 
  551.      which registration is required for continued use.  The registered 
  552.      version of VFD includes input/output file formats that are not included 
  553.      in the Shareware version.
  554.  
  555.      The Shareware version of VFD may be placed on computer bulletin boards 
  556.      and distributed on diskette by Shareware vendors, if priced less than 
  557.      $7.00.  VFD may not be distributed bundled with other software or 
  558.      hardware, on CD-ROM, or included on diskette with a book, magazine or 
  559.      other product without the written permission of the author.
  560.  
  561.      VFD(tm) is a trademark of Bob Williamson, CIS 76570,2752.
  562.  
  563.      REGISTRATION:
  564.  
  565.      The registered version of VFD includes the following features:
  566.  
  567.      * PCX and GIF input and output.
  568.      * 16 and 24-bit TGA extract from 16 and 24-bit DIB AVIs.
  569.      * AVITXT.EXE for adding text comments to all AVIs (all codecs). 
  570.        The text comments are displayed with GeeWiz.
  571.  
  572.      Single-copy registration of VFD is $39.00.  The following discount
  573.      schedule applies to quantity and site licenses:
  574.  
  575.                      2 to 4 copies      $29.00 each
  576.                      5 to 9 copies      $24.00 each
  577.                      10 or more copies  $19.00 each
  578.  
  579.      One copy of the VFD software and documentation file is shipped with each 
  580.      quantity order.  The license provides for the stated number of copies 
  581.      to be in use at the site of the purchaser. 
  582.  
  583.      Registered users will be notified by mail of upgrade opprotunities and
  584.      new products as they become avaliable.  The next VFD upgrade following
  585.      registration is sent free to registered users.  Subsequent upgrades are
  586.      half-price to registered users if ordered directly from the author, with 
  587.      the following upgrade free.
  588.  
  589.      Corporate Purchase Orders and checks for VFD registration may be mailed
  590.      directly to the author at the PO Box address listed under Support.  
  591.      Checks should be payable to Bob Williamson in US dollars and drawn on a 
  592.      US bank.  International Postal money orders are also accepted.
  593.  
  594.      Please include $4.00 S&H ($6.00 overseas) with each order.
  595.  
  596.      CREDIT CARD ORDERS:
  597.  
  598.      You can order with M/C, VISA, AMEX, or DISCOVER from Public software
  599.      Library by calling 800-242-4775 or 713-524-6394 or by FAX to 
  600.      713-524-6398 or by CIS Email to 71355,470.  You can also mail credit
  601.      card orders to: 
  602.                                PsL 
  603.                                PO Box 35705
  604.                                Houston, TX 
  605.                                77235-5705 
  606.                                U. S. A.
  607.  
  608.      There is a $4.00 S&H charge ($6.00 overseas) on all orders.  The above 
  609.      numbers are for orders only.
  610.  
  611.      ORDERS FROM UK:
  612.  
  613.      Registration and/or orders can be sent by phone, fax, mail or email to:
  614.      
  615.                                Digital Workshop
  616.                                First Floor
  617.                                8 West Bar
  618.                                BANBURY
  619.                                Oxon
  620.                                OX16 9RR
  621.                                England
  622.  
  623.                                Tel: +44 (0)1295 258335
  624.                                Fax: +44 (0)1295 254590
  625.                                CIS: 74431,1160
  626.                           Internet: 74431.1160@compuserve.com
  627.  
  628.      Access, Mastercard, VISA, American Express, and Delta welcome.
  629.  
  630.      Cheques, money orders and postal orders payable to Digital Workshop.
  631.  
  632.      ORDERS FROM GERMANY, AUSTRIA, SWITZERLAND:
  633.  
  634.                               Holin Datentechnik
  635.                               Buchrainweg 61
  636.                               63069 Offenbach Germany
  637.  
  638.                               Tel: ++49 69 833587
  639.                               Fax: ++49 69 845242
  640.                               CIS: 100441,1366
  641.                          Internet: mholin@bla.robin.de
  642.  
  643.      Mastercard, VISA, American Express, Diners Club welcome.
  644.  
  645.      Checks, money orders and postal orders payable to Holin Datentechnik.
  646.  
  647.      NOTICE:
  648.  
  649.      You accept this program and files with the understanding that the
  650.      author makes no representations or warranties as to the suitability
  651.      of this program for your particular purpose, and that to the extent
  652.      you use or implement this program in your own setting, you do so at
  653.      your own risk.  In no event will the author be liable for any damages,
  654.      whether consequential, incidental, or special, arising out of the
  655.      use or inability to use the program.
  656.      
  657.      REVISION HISTORY:
  658.  
  659.      Version 1.0 05/16/94 (CD-ROM release Aug '94)
  660.      ______________________________________________________________________
  661.      Version 1.1 07/05/94
  662.      General revision too extensive to detail.
  663.      _______________________________________________________________________
  664.      Version 1.2 07/23/94
  665.      Maximum image size increased from 640x480 to 1024x768.
  666.      _______________________________________________________________________
  667.      Version 1.3 08/25/94
  668.      Verifies AVI infile index - if bad, walks RIFF chunks for processing.
  669.      Reduced XMS requirement.
  670.      Included GeeWiz, the Freeware AVI player for DOS.
  671.      _______________________________________________________________________
  672.      Version 1.4 10/10/94
  673.      Improved processing speed for Repeat frames & compress (skipped frames).
  674.      Improved processing speed for Luminance option.
  675.      Write Palette option is now independent from extract/create options.
  676.      Writes AVI index records for 64k frames maximum (was 4096).
  677.      Added FLIP_ON and FLIP_OFF makefile keywords.
  678.      Added doc reference on how to obtain free copy of Video for Windows.
  679.      -----------------------------------------------------------------------
  680.      Version 1.5 10/31/94
  681.      Added Flip command line param (-B4).
  682.      Numpic series are sorted on filename & extension (was filename only).
  683.      Added TRANSPARENCY_r,g,b makefile keyword.
  684.      Added 16 and 24-bit TGA extract (*registered* version).
  685.      _______________________________________________________________________
  686.      Version 1.6 12/01/94
  687.      Added default Hilite Promotion and Dither values.
  688.      Added text comment display and SVGA video mode to GeeWiz 1.3.
  689.      Included AVITXT 1.0, a utility to add text comments to AVIs.
  690.      _______________________________________________________________________
  691.      Version 1.6a 12/05/94
  692.      Bugfix for palette extraction (-Pn) when -Cn param is used.
  693.      GeeWiz v1.3a is compatible with more SVGA cards.
  694.      ________________________________________________________________________
  695.      Version 1.6b 12/20/94
  696.      Added read compatiblity for Corel RLE AVIs (VFD and Geewiz).
  697.      Increased GeeWiz v1.4 max frame size to 640x480, & added single-step.
  698.      Allowed VFD Hilite & Dither param value of '0', to override defaults.
  699.      Added msvc codec to the Shareware version of AVITXT v1.1.
  700.      ________________________________________________________________________
  701.      Version 1.6c 12/30/94
  702.      Added 8-bit msvc codec playback to GeeWiz 1.5.
  703.      Added developer porting information to VFD.DOC.
  704.      Removed GIF i/o due to demands from CompuServe for fees and royalties.
  705.      ________________________________________________________________________
  706.      Version 1.6d 01/05/95
  707.      Message maintenace release.
  708.